home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CICA 1993 April
/
CICA MS Windows - April 1993.iso
/
unzipped
/
util
/
tw112
/
twman.doc
< prev
next >
Wrap
Text File
|
1992-11-04
|
14KB
|
294 lines
Text Watch V1.10
Thanks to Bob Ostrander from PBS for his good suggestions.
INSTALLATION:
Run Install before using TW and TWE. After running Install both TWE.EXE
and TW.EXE may be copied to any directory. It is recommended that the
directory TW.EXE and TWE.EXE are in be included in your DOS PATH.
GENERAL INFO:
Text Watch (TW) will monitor your Text.INI file for changes and keep a
history of this changes stored in a seperate file.
To make Text Watch simple, there are two types of changes that are
recorded, Addtions and Deletions. Lines which have been edited will be
reported as Deleted and Added, its not a bug. In fact if you think about
it, you will understand why an edited change is recorded twice. Text Watch
has a limit of about 51K size ASCII files. Text Watch is intented for
configuration type text files and has the following limitations which may be
adjusted as demand requires:
1. Blank lines (TW will remove blank lines when reset)
2. Lines greater than 80 characters (Line is truncated to 80 characters)
3. Files Greater than 640 lines (TW will not process, TWE will truncate
file in memory, not on disk unless it is
saved)
Text Watch or TW will monitor other files besides your WIN.INI
file, but WIN.INI is the default if no name is supplied at the
command line. When an option has been selected which can change
or remove stuff, a confirmation prompt will be displayed asking
you if you are sure (EXCEPT if you use /B). Think before selecting
Yes or using the /B option.
Below is a list of TW critical files that TW creates for each Watch
file. You should not erase any of them (with the exception of *.TW)
if you wish TW to operate properly :
The Watch Filename -> WIN.INI or anyfile
TW Creates:
The Original Backup -> WIN.TW or anyfile.TW
* The Last Change File -> L_WIN.TWL or L_anyfile.TWL
* The History File -> WIN.TWH or anyfile.TWH
Files with a * next to them are hidden from a normal directory search.
The Watch File (any ASCII Text file):
This is the file which you wish to Watch for changes.
The Original Backup:
This file is created by TW the first time the file is monitored so
that if total disaster strikes. You can resort back the original.
If you delete this file, TW will make another *.TW file of the
current file. (its better to just leave this file alone)
The Last Change File (L_*.TWL):
This file is compared with the Watch File for changes. First the
file sizes are checked, then the file date and time are compared.
If any of these do not compare TW assumes the Watch File has been
changed and begins comparing the Last Change File and the Watch
file for Additions and Deletions. The results are stored in the
*.TWH file or History file. The Last Change File is then updated to
match the Watch file. If you delete this file or TW cannot find it
in the current directory, TW will assume it hasn't been run on this
file and Enable itself. This file is by default, always hidden from
view unless option /U is used.
The History File (*.TWH):
This file keeps a running list of changes to the Watch file and
includes the Date and Time of the change and the actual changes.
This file is by default, always hidden from view unless option /U
is used.
CAUTION: Be very careful if you decide to edit your history file.
Incorrect changes to you History file can lead to unexpected
results or lost data in the file when you run TW. See your
registered user Manual for History file formats.
TW.EXE (Text Watch)
For best use, install TW.EXE and TWE.EXE in a directory that is included
in your search PATH.
TW is run from the command line or from TWE before a file may be modified
and then after at some point. The best way to use TW is in a Batch file,
such as a WINDOWS.BAT with the command:
WIN
TW *.INI <-- This will check all INI files
When you exit Windows you will be notified if thess files have changed, and
what was changed.
The TW Text Watch Status line comment meanings:
(ENABLED) = Text Watch has set this file up to be watched
(DISABLED) = Text Watch has removed its files. File is not setup to
be watched.
(OPTIMIZED n) = n Blank or Empty lines were removed from file.
(UPDATED) = History and Last Change File updated with new changes.
(REVERSED) = Last changes to file have been reversed
(CONFLICT CHECK) = See Option /1
(CHANGES Detected) = Changes found in file since last checked.
(NO CHANGES Detected) = No changes found in file since last checked.
TW has the following usage format: (Each option is seperated by a space)
Descriptions followed by an * indicate a confirmation prompt is displayed
asking you if you are sure before the action is executed unless the /B
option was used.
TW FileSpec <Options>
Options: /B = Bypass Confirmation prompt.
Using this option will cause all Are You Sure
prompts to bypassed as if Yes were selected.
Careful here, this used in combination with the
/C or /E switch could be trouble.
/C = Clear History File and Settings (Reset)
Wipes out any entries in your history file.
Sets files as if it were the first time TW was
run on the selected filespec.*
/D = Do Not make *.TW file (ie. Original Backup)
Do not make a backup copy of this file before
Resetting file Information. This option should
be included each time TW is run if you do not
wish a *.TW file to be created.
CAUTION: It is recommended you do Not use this
option unless you are an experienced
user.
/E = Erase TW watch files in directory. Any FileSpec
entered is disregarded, so be careful if you
use the /B option or all TW files in the directory
will be removed. *
(TW Files: anyfile.TW, anyfile.TWL, and anyfile.TWH)
/L = Reverse Last Change in History File
Restore the last change in your history file to
your Watch file.*
/P = Pause before exiting TW.
Its good to use this switch when running from TWE.
TW will pause with a 'Press any key' message before
returning to TWE or DOS
/R = Reverse any New changes.
Automatically will restore this file to old copy
whenever a new change is detected.*
/S = Display any Changes on Screen.
Display the text that was changed on the screen.
Show added and deleted text.
/T = Show all History files that TW is using in the
selected directory. Any FileSpec entered is
disregarded and all TW History files are listed.
/U = Do not Hide or Unhide TW watch files. Must be
used each time TW is run to keep these files
unhidden.
/1 = Check for filename conflicts (ie. SYSTEM.INI and
SYSTEM.BAT in same directory) in current directory
using FileSpec. If any conflict is found TW will
exit to DOS after displaying files which may
conflict and the message (CONFLICT DISCOVERED),
otherwise (NO CONFLICT FOUND) will be displayed
TW will continue. This switch is only useful when
DOS wildcards are used for the FileSpec.
I like to use the following command line for my INI files:
TW *.INI /P /S
This will check (or the first time, reset) all my INI files, Display
a list of changes, if any, and Pause before exiting to TWE or DOS.
This is the best option to use for Windows. If you restore one INI
file that has changed you should also restore your other INI files
which have also changed.
TW C:\WINDOWS\*.INI /R Will reverse any changes it finds in your
INI files.
TW C:\WINDOWS\*.INI /L Will reverse the last changes that were
recorded in the INI files History File.
TW C:\WINDOWS\*.INI /L /B Will perform the same operation as above with
no confirmation prompt.
NOTE: TW and TWE do not process Blank lines. In fact, blank lines in
your INI files make Windows startup slower. Text Watch (TW.EXE) will
remove Blank lines when a history file is reset. See (OPTIMIZED)
under Text Watch Status.
CAUTION:
Be careful when using wildcards in the FileSpec because
files which aren't true ASCII text files will be processed
incorrectly. If you do use TW on a binary file restore the
*.TW (ie. Original Backup) Also, as an added safety feature
TW will Not process (Watch) files with the extensions:
*.TW *.TWH *.TWL *.COM *.EXE *.OBJ *.PIF *.DLL
*.GRP *.PCX *.OVL *.BMP *.GIF *.PIC *.BIN
It is not safe to use the filespec *.* since some files may not
be ASCII and have different extensions than those listed above.
TWE.EXE (Text Watch Editor V1.12)
Usage: TWE <filename>
TWE allows you to edit any text files that are 640 lines or less. (the
limit for TW as well, which is about 51K) You can also run TW from within
TWE and restore selected last changes. TWE is alot more powerful (and more
dangerous) than TW and allows for reverse to anywhere in your history file.
Below is a listing of keys available in the editor and short descriptions of
their functions. The TW Editor is compatible with WIN.INI files. To load a
file and go directly to the TWE editor, type a space, then the filename.
F1 = Help, brings up display of available keys
F2 = Save current edit file, if being watched by TW then scan for
changes.
F3 = Load/Create, Load or create another file.
F4 = Mark Block, Mark lines of text to copy or delete
F5 = Copy Block, Copy Marked lines to cursor
F6 = Delete Block, Delete Marked Lines
F7 = Change Editor Colors, Changed the colors of the editor
F8 = Print File, Print the current edit file to selected printer
F9 = Show File Change History, Show History file for current edit file
F10 = Restore Last History Changes, Restore last changes.
Esc = Exit/Save
Alt-D = Show current Path
Alt-I = Information on current file Item, If you are editing your
WIN.INI or CONFIG.SYS file, place the cursor at the item you wish more
information on and press the Alt-I keys. Press and hold down the Alt
key, then press the I key at the same time.
This option may include information on other files such as SYSTEM.INI,
and AUTOEXEC.BAT in future releases depending on the number of
registrations and requests for it. You may also create your on info
file by following the Format and nameing conventions of WIN.HLP or
CONFIG.HLP files. (ie. WIN.HLP for WIN.INI, CONFIG.HLP for CONFIG.SYS)
Alt-S = Search and/or Replace text. At the replace prompt press the enter key
if you on wish to search for text.
Distribution Guidelines:
TW may be distributed freely as long as the following guidelines are
observed:
1) Is distributed with all files in the Original Compressed format and
no file is modified.
2) No charge be incurred other than a minimal shipping & handling fee
not to exceed $10 US dollars
Below is a list of files which should be contained on your Shareware Diskette
or compressed file.
Files having an * preceding them may be erased if not used, or in the case
of INSTALL.EXE, after it is used.
Filename Date Time Description
------------- ---- ---- --------------------------------------------
*INSTALL.EXE 00-00-80 00:00 Install TW.EXE and TWE.EXE use
TW.EXE 00-00-80 00:00 Text Watch Command line utility
TWE.EXE 00-00-80 00:00 Text Watch Editor utility
EDITOR.HLP 00-00-80 00:00 Text Watch Editor help
*WIN.HLP 00-00-80 00:00 WIN.INI Information on Item Help File
*CONFIG.HLP 00-00-80 00:00 CONFIG.SYS Information on Item Help File
*TWMAN.DOC 00-00-80 00:00 General Information and Directions for use
REGISTER.DOC 00-00-80 00:00 Your Registration form for Text Watch
*READ.ME 00-00-80 00:00 Last minute update or information
*PRINTREG.BAT 00-00-80 00:00 Print your registration form
For questions or to request customized versions of TW send an EMAIL to Mark
Vitt CompuServe ID 70053,2236. Complete Manual and Newest Version is available
to registered users only. See REGISTER.DOC for more information.
This is a Shareware Program - After a 30 day trial you are required either
to Register your copy or remove it from use on your system. See REGISTER.DOC
for registration information.